home *** CD-ROM | disk | FTP | other *** search
/ AGA Toolkit '97 / The AGA Toolkit '97.iso / miscellaneous / help / dos / dosman / man / setenv < prev    next >
Encoding:
Text File  |  1996-09-07  |  2.2 KB  |  67 lines
  1.  
  2.  
  3.  
  4.      SetEnv(V1.3) 
  5.  
  6.  
  7.      NAME
  8.           SetEnv - Set or delete an environment variable in the 
  9.         ENV: handler.
  10.  
  11.      SYNOPSIS
  12.           SetEnv Varname [String]
  13.  
  14.      DESCRIPTION
  15.             This command sets or delete the value of environment 
  16.         variables using the new ENV: handler introduced by 
  17.         Commodore.  It takes the name of a variable and the value 
  18.         to set it to.
  19.  
  20.             An environment variable is a variable that is 
  21.         accessable by all tasks.  Note that ENV: is currently 
  22.         just a directory in RAM:, it is not a true handler. Maybe 
  23.         in the furture global environmental varibles may be 
  24.         stored in RAM reserved for the system and then 
  25.         manipulated by their own device handler, as the local 
  26.         environments are.
  27.  
  28.      KEYWORDS
  29.         Varname
  30.             The name of the environment variable to set. This is 
  31.         the name of the text files stored in the ENV: directory. 
  32.         Using the SETENV command copies the text string to this 
  33.         file.
  34.             2.x/3.x has several global variables which are 
  35.         automatically set for you, or you can set for yourself.  
  36.         These include:
  37.       
  38.         Kickstart/Workbench: These variables are created during
  39.         system startup and contain the version numbers of the
  40.         Kickstart and Workbench you are using.
  41.  
  42.         Editor: Recognized by some Workbench programs such as 
  43.         MORE. If you set this variable to the path name of your
  44.         favorite text editor, MORE allows you to bring up the
  45.         program to edit the current file by pressing Shift-E.
  46.  
  47.         [string]
  48.             The text string attached to the environmental 
  49.         variable. If there are any spaces in the text then you 
  50.         must enclose the entire string in quotes. If there is no 
  51.         string specified then an empty string will be copied to 
  52.         the variable. 2.x/3.x only: To remove the string then use 
  53.         the UNSETENV command.       
  54.         
  55.      EXAMPLE
  56.  
  57.         1. Copy the name Bar to the environment variable named
  58.            foo:
  59.  
  60.           SetEnv Foo Bar
  61.  
  62.         2. To remove a text string associated with the environment
  63.            variable Foo:
  64.  
  65.           SetEnv Foo
  66.  
  67.